home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / man / cat.n / label.n < prev    next >
Text File  |  1995-07-25  |  7KB  |  132 lines
  1.  
  2.  
  3.  
  4.      llllaaaabbbbeeeellll((((nnnn))))                     TTTTkkkk (((( ))))                      llllaaaabbbbeeeellll((((nnnn))))
  5.  
  6.  
  7.  
  8.      _________________________________________________________________
  9.  
  10.      NNNNAAAAMMMMEEEE
  11.           label - Create and manipulate label widgets
  12.  
  13.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  14.           llllaaaabbbbeeeellll _p_a_t_h_N_a_m_e ?_o_p_t_i_o_n_s?
  15.  
  16.      SSSSTTTTAAAANNNNDDDDAAAARRRRDDDD OOOOPPPPTTTTIIIIOOOONNNNSSSS
  17.           aaaannnncccchhhhoooorrrr          bbbboooorrrrddddeeeerrrrWWWWiiiiddddtttthhhh    ffffoooorrrreeeeggggrrrroooouuuunnnndddd      rrrreeeelllliiiieeeeffff         |
  18.           bbbbaaaacccckkkkggggrrrroooouuuunnnndddd      ccccuuuurrrrssssoooorrrr         ppppaaaaddddXXXX            tttteeeexxxxtttt           |
  19.           bbbbiiiittttmmmmaaaapppp          ffffoooonnnntttt           ppppaaaaddddYYYY            tttteeeexxxxttttVVVVaaaarrrriiiiaaaabbbblllleeee   |
  20.  
  21.           See the ``options'' manual entry for details on the standard
  22.           options.
  23.  
  24.      WWWWIIIIDDDDGGGGEEEETTTT----SSSSPPPPEEEECCCCIIIIFFFFIIIICCCC OOOOPPPPTTTTIIIIOOOONNNNSSSS
  25.           Name:           hhhheeeeiiiigggghhhhtttt                                        |
  26.           Class:          HHHHeeeeiiiigggghhhhtttt                                        |
  27.           Command-Line Switch:           ----hhhheeeeiiiigggghhhhtttt                        |
  28.  
  29.                                                                              ||
  30.                Specifies  a desired height for the label.  If a bitmap  |
  31.                is being displayed in the label then the  value  is  in  |
  32.                screen  units  (i.e.  any  of  the  forms acceptable to  |
  33.                TTTTkkkk____GGGGeeeettttPPPPiiiixxxxeeeellllssss); for text it is in  lines  of  text.   If  |
  34.                this option isn't specified, the label's desired height  |
  35.                is computed from the size of the bitmap or  text  being  |
  36.                displayed in it.                                         |
  37.  
  38.           Name:           wwwwiiiiddddtttthhhh                                         |
  39.           Class:          WWWWiiiiddddtttthhhh                                         |
  40.           Command-Line Switch:           ----wwwwiiiiddddtttthhhh                         |
  41.  
  42.                                                                              ||
  43.                Specifies  a  desired width for the label.  If a bitmap  |
  44.                is being displayed in the label then the  value  is  in  |
  45.                screen  units  (i.e.  any  of  the  forms acceptable to  |
  46.                TTTTkkkk____GGGGeeeettttPPPPiiiixxxxeeeellllssss); for text it is in characters.   If  this  |
  47.                option  isn't  specified,  the label's desired width is  |
  48.                computed from the size of  the  bitmap  or  text  being  |
  49.                displayed in it.
  50.      _________________________________________________________________
  51.  
  52.  
  53.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  54.           The llllaaaabbbbeeeellll  command  creates  a  new  window  (given  by  the
  55.           _p_a_t_h_N_a_m_e  argument)  and  makes  it  into  a  label  widget.
  56.           Additional options, described above, may be specified on the
  57.           command  line or in the option database to configure aspects
  58.           of the label such as its colors,  font,  text,  and  initial
  59.           relief.   The  llllaaaabbbbeeeellll  command returns its _p_a_t_h_N_a_m_e argument.
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 7/23/95)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      llllaaaabbbbeeeellll((((nnnn))))                     TTTTkkkk (((( ))))                      llllaaaabbbbeeeellll((((nnnn))))
  71.  
  72.  
  73.  
  74.           At the time this command is invoked, there must not exist  a
  75.           window named _p_a_t_h_N_a_m_e, but _p_a_t_h_N_a_m_e's parent must exist.
  76.  
  77.           A label is a  widget  that  displays  a  textual  string  or  |
  78.           bitmap.   The label can be manipulated in a few simple ways,
  79.           such as changing its relief  or  text,  using  the  commands
  80.           described below.
  81.  
  82.  
  83.      WWWWIIIIDDDDGGGGEEEETTTT CCCCOOOOMMMMMMMMAAAANNNNDDDD
  84.           The llllaaaabbbbeeeellll command creates a new Tcl command  whose  name  is
  85.           _p_a_t_h_N_a_m_e.   This  command  may  be  used  to  invoke various
  86.           operations on the widget.   It  has  the  following  general
  87.           form:
  88.  
  89.                _p_a_t_h_N_a_m_e _o_p_t_i_o_n ?_a_r_g _a_r_g ...?
  90.           _O_p_t_i_o_n and the _a_r_gs determine  the  exact  behavior  of  the
  91.           command.   The  following  commands  are  possible for label
  92.           widgets:
  93.  
  94.           _p_a_t_h_N_a_m_e ccccoooonnnnffffiiiigggguuuurrrreeee ?_o_p_t_i_o_n? ?_v_a_l_u_e _o_p_t_i_o_n _v_a_l_u_e ...?
  95.                Query  or  modify  the  configuration  options  of  the
  96.                widget.   If  no  _o_p_t_i_o_n  is  specified, returns a list
  97.                describing all of the available  options  for  _p_a_t_h_N_a_m_e
  98.                (see  TTTTkkkk____CCCCoooonnnnffffiiiigggguuuurrrreeeeIIIInnnnffffoooo for information on the format of
  99.                this list).  If _o_p_t_i_o_n is specified with no _v_a_l_u_e, then
  100.                the  command  returns  a  list describing the one named
  101.                option  (this   list   will   be   identical   to   the
  102.                corresponding  sublist  of  the  value  returned  if no
  103.                _o_p_t_i_o_n is specified).   If  one  or  more  _o_p_t_i_o_n-_v_a_l_u_e
  104.                pairs  are  specified,  then  the  command modifies the
  105.                given widget option(s) to have the given value(s);   in
  106.                this  case the command returns an empty string.  _O_p_t_i_o_n
  107.                may have any  of  the  values  accepted  by  the  llllaaaabbbbeeeellll
  108.                command.
  109.  
  110.  
  111.      BBBBIIIINNNNDDDDIIIINNNNGGGGSSSS
  112.           When a new  label  is  created,  it  has  no  default  event
  113.           bindings: labels are not intended to be interactive.
  114.  
  115.  
  116.      KKKKEEEEYYYYWWWWOOOORRRRDDDDSSSS
  117.           label, widget
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  126.  
  127.  
  128.      Page 2                                          (printed 7/23/95)
  129.  
  130.  
  131.  
  132.